home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / cmds / initsprite.man < prev    next >
Text File  |  1992-11-23  |  3KB  |  73 lines
  1. '\" Copyright 1989 Regents of the University of California
  2. '\" Permission to use, copy, modify, and distribute this
  3. '\" documentation for any purpose and without fee is hereby
  4. '\" granted, provided that this notice appears in all copies.
  5. '\" The University of California makes no representations about
  6. '\" the suitability of this material for any purpose.  It is
  7. '\" provided "as is" without express or implied warranty.
  8. '\" 
  9. '\" $Header: /a/newcmds/initsprite/RCS/initsprite.man,v 1.2 89/06/19 14:34:02 jhh Exp $ SPRITE (Berkeley)
  10. '/" 
  11. .so \*(]ltmac.sprite
  12. .HS INITSPRITE cmds
  13. .BS
  14. .SH NAME
  15. initsprite \- First process executed during bootstrap
  16. .SH SYNOPSIS
  17. .nf
  18. \fBinitsprite\fR [\fB\-cfsx\fR] [\fB\-b\fR \fIbootcommand\fR] 
  19. .SH OPTIONS
  20. .IP "\fB\-b\fR \fIbootcommand\fR" 18
  21. \fIBootcommand\fR will be passed to the prom if the machine is rebooted.
  22. This happens if there is an error checking the root partition.
  23. The \fIbootcommands\fR parameter allows the reboot to be done using the same
  24. kernel and arguments as the original boot. 
  25. .IP "\fB\-c\fR" 18
  26. Causes a fileserver to run \fBrootcmds\fR before running \fBdiskcmds\fR. 
  27. \fBRootcmds\fR typically contains commands that allows a non-root fileserver
  28. to serve as root. 
  29. .IP "\fB\-f\fR" 18
  30. Causes a fileserver mount its disks without checking them.
  31. .IP "\fB\-s\fR" 18
  32. Causes \fBinitsprite\fR to exec a login instead of running \fBdiskcmds\fR 
  33. and \fBbootcmds\fR.
  34. .IP "\fB\-x\fR" 18
  35. Causes a fileserver to run \fBrootcmds\fR before running \fBdiskcmds\fR.
  36. .BE
  37.  
  38. .SH DESCRIPTION
  39. .PP
  40. \fBInitsprite\fR is the first user-level program executed when
  41. Sprite bootstraps itself on a machine.  It is invoked as root,
  42. with no arguments.  \fBInitsprite\fR opens the console terminal
  43. on its standard I/O channels, initializes environment variables
  44. like \fBHOST\fR, \fBMACHINE\fR, and \fBPATH\fR, and then invokes
  45. \fBcsh\fR command scripts to perform system initialization.
  46. .PP
  47. \fBInitsprite\fR looks first for a file \fB/boot/cmds/csh\fR;
  48. if it exists, then it is invoked to process the 
  49. command script in \fB/boot/diskcmds\fR.  The purpose of \fBdiskcmds\fR
  50. is to initialize a local disk, if there is one (if there is a local disk
  51. the kernel will load the prefix for \fB/bootTmp\fR and \fB/\fR before invoking
  52. \fBinitsprite\fR).
  53. .PP
  54. The main initialization script is in the file \fB/boot/bootcmds\fR.
  55. However, if it is desirable to perform special initialization
  56. operations for a particular machine, then there should exist a
  57. file \fB/hosts/\fImachine\fB/bootcmds\fR where \fImachine\fR
  58. is the name of the machine to be treated specially;  \fBinitsprite\fR
  59. checks for this file and executes it in preference to \fB/boot/bootcmds\fR.
  60. Typically, the machine-dependent script will source \fB/boot/bootcmds\fR
  61. and then perform machine-specific initialization afterwards.
  62. .PP
  63. If \fBinitsprite\fR successfully executes \fB/boot/bootcmds\fR (or a
  64. machine-specific replacement), then it exits.  Otherwise it
  65. invokes an interactive shell as root on the console device.
  66. Normally \fBbootcmds\fR takes care of starting up \fBlogin\fR
  67. processes.
  68. .PP
  69. For more information see the man page for \fBboot\fR.
  70.  
  71. .SH KEYWORDS
  72. bootstrap, initialization, startup, boot
  73.